package com.tree.backend.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.tree.backend.entity.dto.DemandAuditDTO;
import com.tree.backend.entity.dto.DemandDTO;
import com.tree.backend.entity.dto.DemandQueryDTO;
import com.tree.backend.entity.pojo.Demand;
import com.tree.backend.entity.vo.DemandListVO;
import com.tree.backend.entity.vo.DemandStatsVO;
import com.tree.backend.entity.vo.DemandVO;
import com.tree.backend.entity.vo.EnterpriseVO;
import java.util.List;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * <p>
 * 需求表 服务类
 * </p>
 *
 * @author tree
 * @since 2025-11-06
 */
public interface IDemandService extends IService<Demand> {
    
    /**
     * 获取需求列表
     * @param queryDTO 查询条件
     * @return 分页后的需求列表
     */
    Page<DemandListVO> getDemandList(DemandQueryDTO queryDTO);
    
    /**
     * 获取需求详情
     * @param id 需求ID
     * @return 需求详情
     */
    DemandVO getDemandDetail(Long id);
    
    /**
     * 新增需求
     * @param demandDTO 需求数据
     * @param userId 用户ID
     * @param userType 用户类型
     * @return 创建的需求
     */
    Demand addDemand(DemandDTO demandDTO, Long userId, Integer userType);
    
    /**
     * 更新需求
     * @param id 需求ID
     * @param demandDTO 需求数据
     * @return 更新后的需求
     */
    Demand updateDemand(Long id, DemandDTO demandDTO);
    
    /**
     * 删除需求
     * @param id 需求ID
     */
    void deleteDemand(Long id);
    
    /**
     * 审核需求
     * @param id 需求ID
     * @param auditDTO 审核数据
     * @param auditUserId 审核人ID
     */
    void auditDemand(Long id, DemandAuditDTO auditDTO, Long auditUserId);
    
    /**
     * 获取需求统计信息
     * @return 统计数据
     */
    DemandStatsVO getDemandStats();
    
    /**
     * 根据状态获取对应的状态文本
     * @param status 状态码
     * @return 状态文本
     */
    String getStatusText(Integer status);
    
    /**
     * 获取愿意接单的企业列表
     * @param demandId 需求ID
     * @return 企业列表
     */
    List<EnterpriseVO> getPotentialEnterprises(Long demandId);
    
    /**
     * 选择企业接单
     * @param demandId 需求ID
     * @param enterpriseId 企业ID
     * @return 是否成功
     */
    boolean selectEnterprise(Long demandId, Long enterpriseId);
}
